IRIX Base Documentation 1998 November

home *** CD-ROM | disk | FTP | other *** search

/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cato / Xm / XmDropSite.z / XmDropSite

Wrap

Text File | 1998-10-20 | 46KB | 661 lines

XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))) NNNNAAAAMMMMEEEE XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee - The DropSite Registry SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////DDDDrrrraaaaggggDDDDrrrroooopppp....hhhh>>>> VVVVEEEERRRRSSSSIIIIOOOONNNN This page documents version 1.2 of the Motif library. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN A client registers a widget or gadget as a drop site using the XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeeeRRRReeeeggggiiiisssstttteeeerrrr function. In addition, this routine defines the behavior and capabilities of a drop site by specifying appropriate resources. For example, the XXXXmmmmNNNNiiiimmmmppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss and XXXXmmmmNNNNnnnnuuuummmmIIIImmmmppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss resources identify respectively the selection target types and number of types supported by a drop site. The visual animation effects associated with a drop site are also described with DropSite resources. Drop site animation effects that occur in response to the pointer entering a valid drop site are called drag-under effects. A receiver can select from several animation styles supplied by the toolkit or can provide customized animation effects. Drag-under effects supplied by the toolkit include border highlighting, shadow in/out drawing, and pixmap representation. When a preregister drag protocol style is used, the toolkit generates drag-under visual effects based on the value of the XXXXmmmmNNNNaaaannnniiiimmmmaaaattttiiiioooonnnnSSSSttttyyyylllleeee resource. In dynamic mode, if the drop site XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc resource is NULL, the toolkit also provides animation effects based on the XXXXmmmmNNNNaaaannnniiiimmmmaaaattttiiiioooonnnnSSSSttttyyyylllleeee resource. Otherwise, if the XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc routine is specified, the receiver can either assume responsibility for animation effects (through the XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc routine) or rely on the toolkit to provide animation. Drop sites may overlap. The initial stacking order corresponds to the order in which the drop sites were registered. When a drop site overlaps another drop site, the drag-under effects of the drop site underneath are clipped by the obscuring drop site(s). The XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeeeUUUUppppddddaaaatttteeee routine sets resources for a widget that is registered as a drop site. XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeeeRRRReeeettttrrrriiiieeeevvvveeee gets drop site resource values previously specified for a registered widget. These routines are used instead of XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss and XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss. CCCCllllaaaasssssssseeeessss PPPPaaaaggggeeee 1111 ((((pppprrrriiiinnnntttteeeedddd 4444////33330000////99998888)))) XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))) XmDropSite does not inherit from any widget class. NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss The following table defines a set of widget resources used by the programmer to specify data. To reference a resource by name or by class in a .Xdefaults file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC prefix and use the remaining letters. To specify one of the defined values for a resource in a .Xdefaults file, remove the XXXXmmmm prefix and use the remaining letters (in either lowercase or uppercase, but include any underscores between words). The codes in the access column indicate if the given resource can be set at creation time (CCCC), set by using XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeeeUUUUppppddddaaaatttteeee (SSSS), retrieved by using XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeeeRRRReeeettttrrrriiiieeeevvvveeee (GGGG), or is not applicable (NNNN////AAAA). XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss _______________________________________________________________________________________________________ XmNanimationMask XmCAnimationMask Pixmap XmUNSPECIFIED_PIXMAP CSG XmNanimationPixmap XmCAnimationPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNanimationPixmapDepth XmCAnimationPixmapDepth int 0 CSG XmNanimationStyle XmCAnimationStyle unsigned char XmDRAG_UNDER_HIGHLIGHT CSG XmNdragProc XmCDragProc XtCallbackProc NULL CSG XmNdropProc XmCDropProc XtCallbackProc NULL CSG XmNdropRectangles XmCDropRectangles XRectangle * dynamic CSG XmNdropSiteActivity XmCDropSiteActivity unsigned char XmDROP_SITE_ACTIVE CSG XmNdropSiteOperations XmCDropSiteOperations unsigned char XmDROP_MOVE | XmDROP_COPY CSG XmNdropSiteType XmCDropSiteType unsigned char XmDROP_SITE_SIMPLE CG XmNimportTargets XmCImportTargets Atom * NULL CSG XmNnumDropRectangles XmCNumDropRectangles Cardinal 1 CSG XmNnumImportTargets XmCNumImportTargets Cardinal 0 CSG XXXXmmmmNNNNaaaannnniiiimmmmaaaattttiiiioooonnnnMMMMaaaasssskkkk Specifies a mask to use with the pixmap specified by XXXXmmmmNNNNaaaannnniiiimmmmaaaattttiiiioooonnnnPPPPiiiixxxxmmmmaaaapppp when the animation style is XXXXmmmmDDDDRRRRAAAAGGGG____UUUUNNNNDDDDEEEERRRR____PPPPIIIIXXXXMMMMAAAAPPPP. XXXXmmmmNNNNaaaannnniiiimmmmaaaattttiiiioooonnnnPPPPiiiixxxxmmmmaaaapppp Specifies a pixmap for drag-under animation when the animation style is XXXXmmmmDDDDRRRRAAAAGGGG____UUUUNNNNDDDDEEEERRRR____PPPPIIIIXXXXMMMMAAAAPPPP. The pixmap is drawn with its origin at the upper left corner of the bounding box of the drop site. If the drop site window is larger than the animation pixmap, the portion of the window not covered by the pixmap will be tiled with the window's background color. XXXXmmmmNNNNaaaannnniiiimmmmaaaattttiiiioooonnnnPPPPiiiixxxxmmmmaaaappppDDDDeeeepppptttthhhh Specifies the depth of the pixmap specified by the XXXXmmmmNNNNaaaannnniiiimmmmaaaattttiiiioooonnnnPPPPiiiixxxxmmmmaaaapppp resource. When the depth is 1, the colors are taken from the foreground and background of the drop site widget. For any other Page 2 (printed 4/30/98) XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))) value, drop site animation occurs only if the XXXXmmmmNNNNaaaannnniiiimmmmaaaattttiiiioooonnnnPPPPiiiixxxxmmmmaaaappppDDDDeeeepppptttthhhh matches the depth of the drop site window. Colors are derived from the current colormap. XXXXmmmmNNNNaaaannnniiiimmmmaaaattttiiiioooonnnnSSSSttttyyyylllleeee Specifies the drag-under animation style used when a drag enters a valid drop site. The possible values are XXXXmmmmDDDDRRRRAAAAGGGG____UUUUNNNNDDDDEEEERRRR____HHHHIIIIGGGGHHHHLLLLIIIIGGGGHHHHTTTT The drop site uses highlighting effects. XXXXmmmmDDDDRRRRAAAAGGGG____UUUUNNNNDDDDEEEERRRR____SSSSHHHHAAAADDDDOOOOWWWW____OOOOUUUUTTTT The drop site uses an outset shadow. XXXXmmmmDDDDRRRRAAAAGGGG____UUUUNNNNDDDDEEEERRRR____SSSSHHHHAAAADDDDOOOOWWWW____IIIINNNN The drop site uses an inset shadow. XXXXmmmmDDDDRRRRAAAAGGGG____UUUUNNNNDDDDEEEERRRR____PPPPIIIIXXXXMMMMAAAAPPPP The drop site uses the pixmap specified by XXXXmmmmNNNNaaaannnniiiimmmmaaaattttiiiioooonnnnPPPPiiiixxxxmmmmaaaapppp to indicate that it can receive the drop. XXXXmmmmDDDDRRRRAAAAGGGG____UUUUNNNNDDDDEEEERRRR____NNNNOOOONNNNEEEE The drop site does not use animation effects. A client using a dynamic protocol, may provide drag-under effects in its XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc routine. XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc Specifies the procedure that is invoked when the drop site receives a crossing, motion, or operation changed message. This procedure is called only when a dynamic protocol is used. The type of structure whose address is passed to this procedure is XXXXmmmmDDDDrrrraaaaggggPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. The reason sent to the procedure is one of the following: XXXXmmmmCCCCRRRR____DDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____EEEENNNNTTTTEEEERRRR____MMMMEEEESSSSSSSSAAAAGGGGEEEE XXXXmmmmCCCCRRRR____DDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____LLLLEEEEAAAAVVVVEEEE____MMMMEEEESSSSSSSSAAAAGGGGEEEE XXXXmmmmCCCCRRRR____DDDDRRRRAAAAGGGG____MMMMOOOOTTTTIIIIOOOONNNN____MMMMEEEESSSSSSSSAAAAGGGGEEEE XXXXmmmmCCCCRRRR____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN____CCCCHHHHAAAANNNNGGGGEEEEDDDD____MMMMEEEESSSSSSSSAAAAGGGGEEEE The drag procedure may change the values of some members of the XXXXmmmmDDDDrrrraaaaggggPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt passed to Page 3 (printed 4/30/98) XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))) it. After the drag procedure returns, the toolkit uses the final values in initializing some members of the callback struct passed to the appropriate callbacks of the initiator (the DragContext's XXXXmmmmNNNNddddrrrrooooppppSSSSiiiitttteeeeEEEEnnnntttteeeerrrrCCCCaaaallllllllbbbbaaaacccckkkk, XXXXmmmmNNNNddddrrrrooooppppSSSSiiiitttteeeeLLLLeeeeaaaavvvveeeeCCCCaaaallllllllbbbbaaaacccckkkk, XXXXmmmmNNNNddddrrrraaaaggggMMMMoooottttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk, or XXXXmmmmNNNNooooppppeeeerrrraaaattttiiiioooonnnnCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks). XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc Specifies the procedure that is invoked when a drop (excluding a cancel or interrupt action) occurs on a drop site regardless of the status of the drop site. The type of the structure whose address is passed to this procedure is XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. The reason sent to the procedure is XXXXmmmmCCCCRRRR____DDDDRRRROOOOPPPP____MMMMEEEESSSSSSSSAAAAGGGGEEEE. The drop procedure may change the values of some members of the XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt passed to it. After the drop procedure returns, the toolkit uses the final values in initializing some members of the XXXXmmmmDDDDrrrrooooppppSSSSttttaaaarrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt passed to the initiator's drop start callbacks (the DragContext's XXXXmmmmNNNNddddrrrrooooppppSSSSttttaaaarrrrttttCCCCaaaallllllllbbbbaaaacccckkkk callbacks). XXXXmmmmNNNNddddrrrrooooppppRRRReeeeccccttttaaaannnngggglllleeeessss Specifies a list of rectangles that describe the shape of a drop site. The locations of the rectangles are relative to the origin of the enclosing object. When XXXXmmmmNNNNddddrrrrooooppppRRRReeeeccccttttaaaannnngggglllleeeessss is NULL, the drop site is assumed to be the sensitive area of the enclosing widget. If XXXXmmmmNNNNddddrrrrooooppppSSSSiiiitttteeeeTTTTyyyyppppeeee is XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____CCCCOOOOMMMMPPPPOOOOSSSSIIIITTTTEEEE, this resource cannot be specified by the application. XXXXmmmmNNNNddddrrrrooooppppSSSSiiiitttteeeeAAAAccccttttiiiivvvviiiittttyyyy Indicates whether a drop site is active or inactive. The values are XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____AAAACCCCTTTTIIIIVVVVEEEE and XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____IIIINNNNAAAACCCCTTTTIIIIVVVVEEEE. An active drop site can receive a drop, whereas an inactive drop site is dormant. An inactive drop site is treated as if it was not a registered drop site and any drag- under visuals associated with entering or leaving the drop site do not occur. However, it is still used for clipping drag-under effects. XXXXmmmmNNNNddddrrrrooooppppSSSSiiiitttteeeeOOOOppppeeeerrrraaaattttiiiioooonnnnssss Specifies the set of valid operations associated with a drop site. This resource is a bit mask that is formed by combining one or more of the following values using a bitwise operation such as inclusive OR (|): XXXXmmmmDDDDRRRROOOOPPPP____CCCCOOOOPPPPYYYY, XXXXmmmmDDDDRRRROOOOPPPP____LLLLIIIINNNNKKKK, and Page 4 (printed 4/30/98) XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))) XXXXmmmmDDDDRRRROOOOPPPP____MMMMOOOOVVVVEEEE. The value XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP for this resource indicates that no operations are valid. XXXXmmmmNNNNddddrrrrooooppppSSSSiiiitttteeeeTTTTyyyyppppeeee Specifies the type of the drop site. The possible values are XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____SSSSIIIIMMMMPPPPLLLLEEEE The widget does not have any additional children that are registered as drop sites. XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____CCCCOOOOMMMMPPPPOOOOSSSSIIIITTTTEEEE The widget will have children that are registered as drop sites. XXXXmmmmNNNNiiiimmmmppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss Specifies the list of target atoms that this drop site accepts. XXXXmmmmNNNNnnnnuuuummmmDDDDrrrrooooppppRRRReeeeccccttttaaaannnngggglllleeeessss Specifies the number of rectangles in the XXXXmmmmNNNNddddrrrrooooppppRRRReeeeccccttttaaaannnngggglllleeeessss list. If the drop site type is XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____CCCCOOOOMMMMPPPPOOOOSSSSIIIITTTTEEEE, this resource can not be specified by the application. XXXXmmmmNNNNnnnnuuuummmmIIIImmmmppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss Specifies the number of atoms in the target atom list. CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn A pointer to the following structure is passed to the XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc routine when the drop site receives crossing, motion, or operation changed messages. ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt {{{{ iiiinnnntttt _r_e_a_s_o_n;;;; XXXXEEEEvvvveeeennnntttt ****_e_v_e_n_t;;;; TTTTiiiimmmmeeee _t_i_m_e_S_t_a_m_p;;;; WWWWiiiiddddggggeeeetttt _d_r_a_g_C_o_n_t_e_x_t PPPPoooossssiiiittttiiiioooonnnn _x;;;; PPPPoooossssiiiittttiiiioooonnnn _y;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_d_r_o_p_S_i_t_e_S_t_a_t_u_s;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_o_p_e_r_a_t_i_o_n;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_o_p_e_r_a_t_i_o_n_s;;;; BBBBoooooooolllleeeeaaaannnn _a_n_i_m_a_t_e;;;; }}}} XXXXmmmmDDDDrrrraaaaggggPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt,,,, ****XXXXmmmmDDDDrrrraaaaggggPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkk;;;; Page 5 (printed 4/30/98) XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))) _r_e_a_s_o_n Indicates why the callback was invoked. _e_v_e_n_t Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback. _t_i_m_e_S_t_a_m_p Specifies the timestamp of the logical event. _d_r_a_g_C_o_n_t_e_x_t Specifies the ID of the DragContext widget associated with the transaction. _x Indicates the x-coordinate of the pointer relative to the drop site. _y Indicates the y-coordinate of the pointer relative to the drop site. _d_r_o_p_S_i_t_e_S_t_a_t_u_s An IN/OUT member that indicates whether or not a drop site is valid. When the _r_e_a_s_o_n is XXXXmmmmCCCCRRRR____DDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____EEEENNNNTTTTEEEERRRR____MMMMEEEESSSSSSSSAAAAGGGGEEEE or XXXXmmmmCCCCRRRR____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN____CCCCHHHHAAAANNNNGGGGEEEEDDDD____MMMMEEEESSSSSSSSAAAAGGGGEEEE, or when the reason is XXXXmmmmCCCCRRRR____DDDDRRRRAAAAGGGG____MMMMOOOOTTTTIIIIOOOONNNN____MMMMEEEESSSSSSSSAAAAGGGGEEEE or XXXXmmmmCCCCRRRR____DDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____LLLLEEEEAAAAVVVVEEEE____MMMMEEEESSSSSSSSAAAAGGGGEEEE and the pointer is not in the same drop site as on the previous invocation of the drag procedure, the toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s as follows: the toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____VVVVAAAALLLLIIIIDDDD if the DragContext's XXXXmmmmNNNNeeeexxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss and the DropSite's XXXXmmmmNNNNiiiimmmmppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss are compatible and if the initial value of the _o_p_e_r_a_t_i_o_n member is not XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. Otherwise, the toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____IIIINNNNVVVVAAAALLLLIIIIDDDD. When the _r_e_a_s_o_n is XXXXmmmmCCCCRRRR____DDDDRRRRAAAAGGGG____MMMMOOOOTTTTIIIIOOOONNNN____MMMMEEEESSSSSSSSAAAAGGGGEEEE or XXXXmmmmCCCCRRRR____DDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____LLLLEEEEAAAAVVVVEEEE____MMMMEEEESSSSSSSSAAAAGGGGEEEE and the pointer is within the same drop site as on the previous invocation of the drag procedure, the toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to the value of _d_r_o_p_S_i_t_e_S_t_a_t_u_s at the time the previous invocation of the drag procedure returns. The drag procedure may change the value of this member. After the drag procedure returns, the toolkit uses the final value in initializing the _d_r_o_p_S_i_t_e_S_t_a_t_u_s member of the callback struct passed to the appropriate callbacks of the initiator. _o_p_e_r_a_t_i_o_n An IN/OUT member that identifies an operation. Page 6 (printed 4/30/98) XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))) The toolkit initializes _o_p_e_r_a_t_i_o_n by selecting an operation from the bitwise AND of the initial value of the _o_p_e_r_a_t_i_o_n_s member and the value of the DropSite's XXXXmmmmNNNNddddrrrrooooppppSSSSiiiitttteeeeOOOOppppeeeerrrraaaattttiiiioooonnnnssss resource. The toolkit searches this set first for XXXXmmmmDDDDRRRROOOOPPPP____MMMMOOOOVVVVEEEE, then for XXXXmmmmDDDDRRRROOOOPPPP____CCCCOOOOPPPPYYYY, then for XXXXmmmmDDDDRRRROOOOPPPP____LLLLIIIINNNNKKKK, and initializes _o_p_e_r_a_t_i_o_n to the first operation it finds in the set. If the toolkit finds none of these operations in the set, it initializes _o_p_e_r_a_t_i_o_n to XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. The drag procedure may change the value of this member. After the drag procedure returns, the toolkit uses the final value in initializing the _o_p_e_r_a_t_i_o_n member of the callback struct passed to the appropriate callbacks of the initiator. _o_p_e_r_a_t_i_o_n_s An IN/OUT member that indicates the set of operations supported for the source data. If the user does not select an operation (by pressing a modifier key), the toolkit initializes _o_p_e_r_a_t_i_o_n_s to the value of the DragContext's XXXXmmmmNNNNddddrrrraaaaggggOOOOppppeeeerrrraaaattttiiiioooonnnnssss resource. If the user does select an operation, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to the bitwise AND of the corresponding operation and the value of the DragContext's XXXXmmmmNNNNddddrrrraaaaggggOOOOppppeeeerrrraaaattttiiiioooonnnnssss resource. If the resulting set of operations is empty, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. The drag procedure may change the value of this member. After the drag procedure returns, the toolkit uses the final value in initializing the _o_p_e_r_a_t_i_o_n_s member of the callback struct passed to the appropriate callbacks of the initiator. _a_n_i_m_a_t_e An OUT member that indicates whether the toolkit or the receiver client provides drag-under effects for a valid drop site. If _a_n_i_m_a_t_e is set to True, the toolkit provides drop site animation per the XXXXmmmmNNNNaaaannnniiiimmmmaaaattttiiiioooonnnnSSSSttttyyyylllleeee resource value; if it is set to False, the receiver generates drag-under animation effects. A pointer to the following structure is passed to the XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc routine when the drop site receives a drop message: ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt {{{{ Page 7 (printed 4/30/98) XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))) iiiinnnntttt _r_e_a_s_o_n;;;; XXXXEEEEvvvveeeennnntttt ****_e_v_e_n_t;;;; TTTTiiiimmmmeeee _t_i_m_e_S_t_a_m_p;;;; WWWWiiiiddddggggeeeetttt _d_r_a_g_C_o_n_t_e_x_t;;;; PPPPoooossssiiiittttiiiioooonnnn _x;;;; PPPPoooossssiiiittttiiiioooonnnn _y;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_d_r_o_p_S_i_t_e_S_t_a_t_u_s;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_o_p_e_r_a_t_i_o_n;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_o_p_e_r_a_t_i_o_n_s;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_d_r_o_p_A_c_t_i_o_n;;;; }}}} XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt,,,, ****XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkk;;;; _r_e_a_s_o_n Indicates why the callback was invoked. _e_v_e_n_t Specifies the XXXXEEEEvvvveeeennnntttt that triggered the callback. _t_i_m_e_S_t_a_m_p Specifies the timestamp of the logical event. _d_r_a_g_C_o_n_t_e_x_t Specifies the ID of the DragContext widget associated with the transaction. _x Indicates the x-coordinate of the pointer relative to the drop site. _y Indicates the y-coordinate of the pointer relative to the drop site. _d_r_o_p_S_i_t_e_S_t_a_t_u_s An IN/OUT member that indicates whether or not a drop site is valid. The toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____VVVVAAAALLLLIIIIDDDD if the DragContext's XXXXmmmmNNNNeeeexxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss and the DropSite's XXXXmmmmNNNNiiiimmmmppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss are compatible and if the initial value of the _o_p_e_r_a_t_i_o_n member is not XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. Otherwise, the toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____IIIINNNNVVVVAAAALLLLIIIIDDDD. The drop procedure may change the value of this member. After the drop procedure returns, the toolkit uses the final value in initializing the _d_r_o_p_S_i_t_e_S_t_a_t_u_s member of the XXXXmmmmDDDDrrrrooooppppSSSSttttaaaarrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt passed to the initiator's drop start callbacks (the DragContext's XXXXmmmmNNNNddddrrrrooooppppSSSSttttaaaarrrrttttCCCCaaaallllllllbbbbaaaacccckkkk callbacks). _o_p_e_r_a_t_i_o_n An IN/OUT member that identifies an operation. The toolkit initializes _o_p_e_r_a_t_i_o_n by selecting Page 8 (printed 4/30/98) XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))) an operation from the bitwise AND of the initial value of the _o_p_e_r_a_t_i_o_n_s member and the value of the DropSite's XXXXmmmmNNNNddddrrrrooooppppSSSSiiiitttteeeeOOOOppppeeeerrrraaaattttiiiioooonnnnssss resource. The toolkit searches this set first for XXXXmmmmDDDDRRRROOOOPPPP____MMMMOOOOVVVVEEEE, then for XXXXmmmmDDDDRRRROOOOPPPP____CCCCOOOOPPPPYYYY, then for XXXXmmmmDDDDRRRROOOOPPPP____LLLLIIIINNNNKKKK, and initializes _o_p_e_r_a_t_i_o_n to the first operation it finds in the set. If it finds none of these operations in the set, it initializes _o_p_e_r_a_t_i_o_n to XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. The drop procedure may change the value of this member. After the drop procedure returns, the toolkit uses the final value in initializing the _o_p_e_r_a_t_i_o_n member of the XXXXmmmmDDDDrrrrooooppppSSSSttttaaaarrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt passed to the initiator's drop start callbacks (the DragContext's XXXXmmmmNNNNddddrrrrooooppppSSSSttttaaaarrrrttttCCCCaaaallllllllbbbbaaaacccckkkk callbacks). _o_p_e_r_a_t_i_o_n_s An IN/OUT member that indicates the set of operations supported for the source data. If the user does not select an operation (by pressing a modifier key), the toolkit initializes _o_p_e_r_a_t_i_o_n_s to the value of the DragContext's XXXXmmmmNNNNddddrrrraaaaggggOOOOppppeeeerrrraaaattttiiiioooonnnnssss resource. If the user does select an operation, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to the bitwise AND of the corresponding operation and the value of the DragContext's XXXXmmmmNNNNddddrrrraaaaggggOOOOppppeeeerrrraaaattttiiiioooonnnnssss resource. If the resulting set of operations is empty, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. The drop procedure may change the value of this member. After the drop procedure returns, the toolkit uses the final value in initializing the _o_p_e_r_a_t_i_o_n_s member of the XXXXmmmmDDDDrrrrooooppppSSSSttttaaaarrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt passed to the initiator's drop start callbacks (the DragContext's XXXXmmmmNNNNddddrrrrooooppppSSSSttttaaaarrrrttttCCCCaaaallllllllbbbbaaaacccckkkk callbacks). _d_r_o_p_A_c_t_i_o_n An IN/OUT member that identifies the action associated with the drop. The possible values are XXXXmmmmDDDDRRRROOOOPPPP A drop was attempted. If the drop site is valid, drop transfer handling proceeds. XXXXmmmmDDDDRRRROOOOPPPP____HHHHEEEELLLLPPPP The user has requested help on the drop site. Page 9 (printed 4/30/98) XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))) The drop procedure may change the value of this member. After the drop procedure returns, the toolkit uses the final value in initializing the _d_r_o_p_A_c_t_i_o_n member of the XXXXmmmmDDDDrrrrooooppppSSSSttttaaaarrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt passed to the initiator's drop start callbacks (the DragContext's XXXXmmmmNNNNddddrrrrooooppppSSSSttttaaaarrrrttttCCCCaaaallllllllbbbbaaaacccckkkk callbacks). RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))), XXXXmmmmDDDDrrrraaaaggggIIIIccccoooonnnn((((3333XXXX)))), XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeeeCCCCoooonnnnffffiiiigggguuuurrrreeeeSSSSttttaaaacccckkkkiiiinnnnggggOOOOrrrrddddeeeerrrr((((3333XXXX)))), XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeeeEEEEnnnnddddUUUUppppddddaaaatttteeee((((3333XXXX)))), XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeeeQQQQuuuueeeerrrryyyySSSSttttaaaacccckkkkiiiinnnnggggOOOOrrrrddddeeeerrrr((((3333)))), XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeeeRRRReeeeggggiiiisssstttteeeerrrr((((3333XXXX)))), XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeeeSSSSttttaaaarrrrttttUUUUppppddddaaaatttteeee((((3333XXXX)))), XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeeeUUUUppppddddaaaatttteeee((((3333XXXX)))), XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeeeUUUUnnnnrrrreeeeggggiiiisssstttteeeerrrr((((3333XXXX)))), XXXXmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrr((((3333XXXX)))), and XXXXmmmmTTTTaaaarrrrggggeeeettttssssAAAArrrreeeeCCCCoooommmmppppaaaattttiiiibbbblllleeee((((3333XXXX)))). Page 10 (printed 4/30/98)